home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio / Ham Radio CD-ROM (Emerald Software) (1995).ISO / misc / commo41 / commo.doc < prev    next >
Text File  |  1990-03-11  |  67KB  |  1,899 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                   {COMMO} (tm)
  9.  
  10.  
  11.                      Telecommunications for PC Compatibles
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                       by
  20.  
  21.                                 Fred P. Brucker
  22.  
  23.                              Post Office Box 9103
  24.                              Santa Rosa, CA 95405
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                                  Release 4.1
  31.  
  32.                                March 12, 1990
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.        This program and associated documentation are the property of the
  44.        author and may not be sold without permission.  They may be freely
  45.        distributed, unaltered and as a unit, via electronic bulletin board
  46.        systems.  Permission to distribute on diskette or in any other
  47.        manner must be obtained in writing.
  48.  
  49.        The author does not guarantee the program to be free from defects
  50.        and may not be held responsible for loss caused by such.  Your use
  51.        of this program constitutes your acceptance of these terms.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.          (C) Copyright 1989,1990  Fred P. Brucker  All Rights Reserved
  62.  
  63.  
  64.  
  65.                           Welcome to {COMMO} (tm)                   page ii
  66.  
  67.  
  68.        ---------------------
  69.        Licensing Information
  70.        ---------------------
  71.  
  72.        {COMMO} is not a public domain program and is not free.  It is
  73.        classified as "SHAREWARE."  What this means is that you may use the
  74.        program for 30 days to determine its suitability to your
  75.        application.  If after that time you decide to continue using
  76.        {COMMO} you must pay the registration fee.
  77.  
  78.        {COMMO} is a unique program and represents a great deal of work.  A
  79.        lot of functionality has been compressed into a small package, and
  80.        more features are being added on a continuing basis.  If you find
  81.        {COMMO} useful and enjoyable, you can help support future
  82.        improvements by registering your copy.
  83.  
  84.  
  85.        A single-user license is $25.00.  A diskette (5.25" or 3.5") will be
  86.        provided for a $5.00 handling fee.  Send a check or money order (US
  87.        funds) to the address on the cover page of this document.  Details
  88.        and multi-user (site) license information are provided in the file
  89.        REGISTER.FRM.
  90.  
  91.         
  92.        Thank you, and I hope you enjoy {COMMO}.
  93.  
  94.                                                Fred P. Brucker
  95.  
  96.  
  97.  
  98.                           Welcome to {COMMO} (tm)                  page iii
  99.  
  100.  
  101.  
  102.                                    Contents
  103.                                    --------
  104.  
  105.           Principal Features . . . . . . . . . . . . . . . . . . . . .    1
  106.           The Best Way to Learn {COMMO} Quickly  . . . . . . . . . . .    2
  107.  
  108.           Operations Guide / Command Summary . . . . . . . . . . . . .    3
  109.           Uploading / Downloading  . . . . . . . . . . . . . . . . . .    6
  110.           The Internal Editor  . . . . . . . . . . . . . . . . . . . .    6
  111.  
  112.           Getting Started  . . . . . . . . . . . . . . . . . . . . . .    7
  113.           Command Line Options   . . . . . . . . . . . . . . . . . . .    8
  114.           {COMMO} Support Files  . . . . . . . . . . . . . . . . . . .    9
  115.           Initialization Procedure . . . . . . . . . . . . . . . . . .   10
  116.           Terminal Screen  . . . . . . . . . . . . . . . . . . . . . .   10
  117.  
  118.           How to Use Online Help . . . . . . . . . . . . . . . . . . .   11
  119.           Modifying the Help File  . . . . . . . . . . . . . . . . . .   11
  120.  
  121.           Programming {COMMO} Macros . . . . . . . . . . . . . . . . .   12
  122.           Macro-id and Function Summary  . . . . . . . . . . . . . . .   13
  123.           Additional Macro File Rules  . . . . . . . . . . . . . . . .   13
  124.           Executing Macros . . . . . . . . . . . . . . . . . . . . . .   13
  125.           Additional Macro Execution Rules . . . . . . . . . . . . . .   14
  126.           {COMMO} Macro Functions  . . . . . . . . . . . . . . . . . .   15
  127.           Table of {COMMO} Key-id's  . . . . . . . . . . . . . . . . .   27
  128.  
  129.           Appendix A   Setting Up Your Modem . . . . . . . . . . . . .   28
  130.           Appendix B   {COMMO} and DESQview  . . . . . . . . . . . . .   30
  131.           Appendix C   XON/XOFF Protocol . . . . . . . . . . . . . . .   31
  132.           Appendix D   Strings in {COMMO} Files  . . . . . . . . . . .   32
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.        DESQview is a trademark of Quarterdeck Office Systems
  141.        DSZ is a product of Omen Technology Inc.
  142.        LIST is a product of Vernon D. Buerg
  143.  
  144.  
  145.  
  146.                           Welcome to {COMMO} (tm)                   page 1
  147.  
  148.  
  149.        ------------------
  150.        Principal Features
  151.        ------------------
  152.  
  153.        {COMMO} is small in size and executes quickly.
  154.  
  155.        Powerful Macro Processor allows you to:
  156.  
  157.        1) write macro "programs" to automate many common operations such as
  158.           logins, reading messages, uploading/downloading.  You can sit
  159.           back and watch {COMMO} do the work -- or you can let {COMMO}
  160.           perform these tasks in the middle of the night while you sleep.
  161.  
  162.        2) assign any Function Key, Alt Key or Keypad Key to send a string
  163.           to the modem, execute any DOS command, start any macro or
  164.           initiate any {COMMO} function.
  165.  
  166.        3) edit all macros without exiting {COMMO}, using the Internal
  167.           Editor.  
  168.  
  169.        Unlimited entries in the Dialing Directory.  Multi Number Dialing
  170.        supported from the command line.  AutoBaud detect.  Macro may be
  171.        linked to each directory entry.
  172.  
  173.        DESQview aware.  {COMMO} operates in about 35k, will execute with
  174.        DSZ in a 100k DV window (depends on support file sizes).
  175.  
  176.        Built-in ANSI emulation.  ANSI keypad keys configured in Macro File
  177.        to access full-screen editors.
  178.  
  179.        ASCII Upload to send messages and text files.  Features line pacing
  180.        and blank line expansion.
  181.  
  182.        Configuration File, Dialing Directory and Macro File may be edited
  183.        with full-function Internal Editor.  String search available in all
  184.        file windows.  Most features are fully configurable.
  185.  
  186.        Support for any four serial ports.  Port addresses and IRQ's are
  187.        configurable.  Port speeds up to 115,200 bps (machine dependent). 
  188.        Support for NS16550A buffered UART chip.
  189.  
  190.        Serial port signal lights may be displayed on status line, including
  191.        send and receive.
  192.  
  193.        Capture Log to save all text from the screen to a disk file.
  194.        Screen Image Dump to save current screen to a disk file.
  195.        Print Log to write all text from the screen to the printer.
  196.  
  197.        Extensive context-related Online Help.
  198.  
  199.  
  200.        And {COMMO} is elegant, easy to learn and fun to use!
  201.  
  202.  
  203.  
  204.                           Welcome to {COMMO} (tm)                   page 2
  205.  
  206.  
  207.                   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  208.                   -------------------------------------
  209.                   The Best Way to Learn {COMMO} Quickly
  210.                   -------------------------------------
  211.                   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  212.  
  213.  
  214.        1) Read the section "Operations Guide / Command Summary" for a   
  215.           quick introduction to all of {COMMO}'s commands and features.
  216.  
  217.        2) Read Appendix A "Setting Up Your Modem" for some very important
  218.           instructions pertaining to your specific hardware.
  219.  
  220.        3) Read the section "Getting Started" which will get you up and
  221.           running.
  222.  
  223.        4) Use the extensive Online Help to learn the operating details   
  224.           of the program as you use it.
  225.  
  226.  
  227.        How is it pronounced???  Just like "comma" (,) except for the last
  228.        letter.  It's technical jargon for "communications."
  229.  
  230.  
  231.  
  232.                           Welcome to {COMMO} (tm)                   page 3
  233.  
  234.  
  235.        ----------------------------------
  236.        Operations Guide / Command Summary
  237.        ----------------------------------
  238.  
  239.        Use {COMMO}'s Online (context-related) Help facility to obtain
  240.        operating details for most features.  This section is an overview of
  241.        {COMMO} features and commands, which you should peruse to gain
  242.        rapid, overall familiarity with the program.
  243.  
  244.        (A special section in this document "Programming {COMMO} Macros" is
  245.        devoted to the Macro Processor.  Additionally there are several
  246.        appendices which give details about special program features.)
  247.  
  248.        Note:  the Alt Keys shown are the built-in default key assignments
  249.        for the various {COMMO} functions.  Once you are familiar with these
  250.        functions you may reassign any of the keys using the Macro
  251.        Processor.
  252.  
  253.  
  254.        [Alt-A]   ASCII Upload
  255.        -------   ------------
  256.        Sends prepared messages and other text files to the remote system. 
  257.        This command features Line Pacing or XON/XOFF protocol to control
  258.        the flow of incoming data.
  259.  
  260.  
  261.        [Alt-B]   Send Break Signal
  262.        -------   -----------------
  263.        Sends a Break Signal, used by some systems to interrupt an
  264.        operation.
  265.  
  266.  
  267.        [Alt-C]   Clear Screen
  268.        -------   ------------
  269.        Clears the Terminal Screen to the default colors.
  270.  
  271.  
  272.        [Alt-D]   Dialing Directory
  273.        -------   -----------------
  274.        Maintains a data base of telephone numbers and related information. 
  275.        Dials numbers to establish connections with remote systems. 
  276.        Directory can be updated with the Internal Editor.
  277.  
  278.  
  279.        [Alt-G]   Configuration File
  280.        -------   ------------------
  281.        Contains settings for many of {COMMO}'s operating parameters.  Can
  282.        be modified with the Internal Editor.  Details in Online Help.
  283.  
  284.  
  285.        [Alt-H]   Online Help
  286.        -------   -----------
  287.        Context-related Online Help is available at any time from anywhere
  288.        within {COMMO}.  See also the section "How to Use Online Help."
  289.  
  290.  
  291.  
  292.                           Welcome to {COMMO} (tm)                   page 4
  293.  
  294.  
  295.        [Alt-I]   Screen Image Save
  296.        -------   -----------------
  297.        Appends the image of the current Terminal Screen to a disk file. 
  298.        Very useful for selectively recording information.  Allows you to
  299.        change the name of the Screen Image File at any time.  See also
  300.        "Capture File Options."
  301.  
  302.  
  303.        [Alt-L]   Communication Parameters
  304.        -------   ------------------------
  305.        Changes the serial port, data rate or data format from the Terminal
  306.        Screen.
  307.  
  308.  
  309.        [Alt-M]   Macro Processor
  310.        -------   ---------------
  311.        Executes and maintains {COMMO} macros.  See the section "Programming
  312.        {COMMO} Macros" which shows you how easily you can automate program
  313.        operations, link to external protocols (for Uploading/Downloading),
  314.        assign keys and perform a myriad of other functions.  The Macro File
  315.        is maintained with the Internal Editor.
  316.  
  317.  
  318.        [Alt-O]   Send Modem Initialization String
  319.        -------   --------------------------------
  320.        Used to re-initialize your modem, if necessary.
  321.  
  322.  
  323.        [Alt-P]   Send Current Password
  324.        -------   ---------------------
  325.        Sends Password String defined by the last dialing operation.  This
  326.        feature allows a different Password for each system that you call.
  327.  
  328.  
  329.        [Alt-Q]   Quit Call
  330.        -------   ---------
  331.        Places modem "on-hook" by dropping DTR.  Used to "hang up" the
  332.        telephone line.
  333.  
  334.  
  335.        [Alt-S]   Shell to DOS
  336.        -------   ------------
  337.        Allows you to enter DOS while {COMMO} remains in memory.
  338.  
  339.  
  340.        [Alt-U]   Multi Number Dialing
  341.        -------   --------------------
  342.        Multiple numbers may be "marked" in the Dialing Directory, then
  343.        automatically dialed in sequence until a connection is established. 
  344.        Features the ability to "skip" or "remove" any number from the
  345.        queue.  Also used in conjunction with Dialing Strings on the command
  346.        line and in the MARK function.  See "Command Line Options" and
  347.        "Programming {COMMO} Macros" for details.
  348.  
  349.  
  350.  
  351.                           Welcome to {COMMO} (tm)                   page 5
  352.  
  353.  
  354.        [Alt-X]   Exit from {COMMO}
  355.        -------   -----------------
  356.        Terminates program, exits back to DOS.  May be pressed from the
  357.        Terminal Screen, Dialing Directory or Macro Processor.
  358.  
  359.  
  360.        [Alt-1]   Capture File Options
  361.        -------   --------------------
  362.        When Capture is OPEN all information written to your screen will be
  363.        saved to the designated disk file.  This command allows you to
  364.        OPEN/CLOSE the Capture File and to change to a different file.  See
  365.        also "Screen Image Save."
  366.  
  367.  
  368.        [Alt-2]   Print Log Toggle
  369.        -------   ----------------
  370.        Turns the Print Log ON/OFF.  When ON all information written to your
  371.        screen will be printed to LPT1.  Handy for getting hard-copy of file
  372.        lists, messages, etc.
  373.  
  374.  
  375.        [Alt-3]   Sound Control Toggle
  376.        -------   --------------------
  377.        Enables/disables all sounds, including alarms and beeps.  Alarms and
  378.        the number of alarm rings are individually configurable in the
  379.        Configuration File and in the Macro File.
  380.  
  381.  
  382.        [Alt-4]   ANSI Emulation Toggle
  383.        -------   ---------------------
  384.        Turns ON/OFF ANSI terminal emulation, used by many host systems to
  385.        provide cursor positioning, color and editing functions.
  386.  
  387.  
  388.        [Alt-5]   AutoBaud Toggle
  389.        -------   ---------------
  390.        Allows {COMMO} to adjust automatically to the data rate (speed of
  391.        transmission) of the system you are calling.
  392.  
  393.  
  394.        [Alt-6]   Local Echo Toggle
  395.        -------   -----------------
  396.        Used for calling a host system that does not echo what you type. 
  397.        The host must send a linefeed after each carriage return that you
  398.        type.
  399.  
  400.  
  401.        [Alt-7]   Chat Mode Toggle
  402.        -------   ----------------
  403.        Used for calling another "terminal" program that does not echo what
  404.        you type.  Adds a linefeed after each carriage return.
  405.  
  406.  
  407.  
  408.                           Welcome to {COMMO} (tm)                   page 6
  409.  
  410.  
  411.        [Alt-0]   Signal Light Toggle
  412.        -------   -------------------
  413.        Turns on/off the "modem lights" display on the status line.  Shows
  414.        the state of the RS-232 signals, including send/receive.
  415.  
  416.  
  417.        [Alt-=]   Doorway Mode
  418.        -------   ------------
  419.        Toggles Doorway Mode on/off.  Doorway Mode turns off the status line
  420.        giving a 25-line display and keyboard support for running programs
  421.        remotely.
  422.  
  423.  
  424.        Uploading / Downloading
  425.        -----------------------
  426.        {COMMO} requires the use of external programs such as Omen
  427.        Technology's DSZ.COM to do protocol transfers of files.  The Macro
  428.        File is pre-configured with macros that execute DSZ to perform
  429.        Xmodem, Ymodem and Zmodem uploads and downloads.  Use the Alt-M key
  430.        command to select one of these macros.
  431.  
  432.        Installing DSZ is very easy.  Just place DSZ.COM in a directory
  433.        which is specified in your DOS path statement.  If you don't have a
  434.        path statement in your AUTOEXEC.BAT file, place DSZ.COM in your
  435.        C:\COMMO directory.  Then type "path c:\commo<cr>" before you call
  436.        {COMMO}.
  437.  
  438.  
  439.        The Internal Editor
  440.        -------------------
  441.        {COMMO}'s Internal Editor is easy to use, yet fully functional,
  442.        allowing you to maintain your Configuration File, Dialing Directory
  443.        and Macro File with lines up to 255 characters long.  Full details
  444.        in Online Help.
  445.  
  446.  
  447.  
  448.                           Welcome to {COMMO} (tm)                   page 7
  449.  
  450.  
  451.        ---------------
  452.        Getting Started
  453.        ---------------
  454.  
  455.        First make sure that all the files from the {COMMO} package are in
  456.        one directory or on one diskette.  Five of these files are used to
  457.        run the {COMMO} program: 
  458.  
  459.             COMMO.COM      the Program File
  460.             COMMO.CFG      the Configuration File
  461.             COMMO.FON      the Dialing Directory File
  462.             COMMO.MAC      the Macro File
  463.             COMMO.HLP      the Online Help File
  464.  
  465.        There are two ways to make sure that {COMMO} will be able to find
  466.        all of its files.  The first method is the simplest and should be
  467.        used if you are not too familiar with DOS commands:
  468.  
  469.        Make sure you are logged into the directory or disk drive where the
  470.        files are located.  Then simply type "commo" at the DOS prompt.  If
  471.        your files are in the directory "C:\COMMO" you would type:
  472.  
  473.                  c:<cr>
  474.                  cd \commo<cr>
  475.                  commo<cr>
  476.  
  477.        (<cr> is the [Enter] or Return key)
  478.  
  479.        Or if the files are on a diskette in drive A you would type:
  480.  
  481.                  a:<cr>
  482.                  commo<cr>
  483.  
  484.        {COMMO} will remember where the files are, so you will be able to
  485.        change directory or drive later without concern.
  486.  
  487.        The second method is a little more advanced, but allows you to run
  488.        {COMMO} no matter what directory or drive you are currently logged
  489.        into:
  490.  
  491.        Use the SET command in DOS to store the {COMMO} path into the
  492.        "environment."  If you place this command in your AUTOEXEC.BAT file
  493.        you won't have to change directories or diskettes to run {COMMO}. 
  494.        If your files are in the directory "C:\COMMO" the command would be:
  495.  
  496.                  set commo=c:\commo
  497.  
  498.        If the files are on the diskette in drive B the command would be:
  499.  
  500.                  set commo=b:
  501.  
  502.        Do not use any extra spaces in the SET command.  And remember to
  503.        place the {COMMO} directory or drive in your PATH command.
  504.  
  505.        IMPORTANT:  Remember to execute the "set commo=" command again if
  506.  
  507.  
  508.  
  509.                           Welcome to {COMMO} (tm)                   page 8
  510.  
  511.  
  512.        you install {COMMO} into a different directory or onto another
  513.        drive.  Otherwise the new copy will refer back to the old directory
  514.        and use the old support files.  This is a common error and can cause
  515.        a lot of head scratching.
  516.  
  517.  
  518.        --------------------
  519.        Command Line Options 
  520.        --------------------
  521.  
  522.          Dialing Strings
  523.          _______________
  524.  
  525.        Dialing Strings may be placed before any command line switches. 
  526.        {COMMO} will search the Dialing Directory for each string and mark
  527.        the first entry where a match is found (case is ignored).
  528.  
  529.        The strings may consist of any part of a Dialing Directory entry
  530.        line and may be separated by commas or spaces.  The following
  531.        characters may not appear in a Dialing String: space, comma, slash
  532.        (/), left or right curly brace.
  533.  
  534.        After entries in the Dialing Directory are marked {COMMO} will check
  535.        for a Startup Macro (see below).  If no valid macro is present Multi
  536.        Number Dialing of the marked systems will begin.  If a macro is
  537.        present it will be started instead.
  538.  
  539.        The Modem Initialization String will be sent before dialing begins
  540.        unless the switch "/i=no" is present on the command line.
  541.  
  542.        Examples:
  543.  
  544.                 commo telegodzilla joes-bbs 4567 
  545.  
  546.                 commo zilla,joes,4567
  547.  
  548.        IMPORTANT: Your modem should be turned on and ready to receive the
  549.        Modem Initialization String before starting the program.
  550.  
  551.  
  552.          Switches
  553.          ________
  554.  
  555.          /c=filename            default:  COMMO.CFG
  556.  
  557.        Alternate Configuration File.  The alternate file must reside in the
  558.        {COMMO} home directory.
  559.  
  560.          /i=[yes/no]            default:  none
  561.  
  562.        This switch may be used to inhibit the Modem Initialization when
  563.        Dialing Strings or a Startup Macro are present: "/i=no."
  564.  
  565.        It may also be used to bypass the question "Initialize modem?" on
  566.        the Initialization Screen: "/i=yes" or "/i=no."
  567.  
  568.  
  569.  
  570.                           Welcome to {COMMO} (tm)                   page 9
  571.  
  572.  
  573.  
  574.          /m=macro-id            default:  none
  575.  
  576.        Startup Macro.  The "macro-id" is a three character macro
  577.        identifier.  If the macro is found in the Macro File it will be
  578.        started.  If the macro is not found the switch will be ignored.
  579.  
  580.        The Modem Initialization String will be sent before starting the
  581.        macro unless the switch "/i=no" is present on the command line. 
  582.  
  583.          /o=bf,bf               default:  17,47
  584.  
  585.        Colors for Initialization Window.  The first field is the text area,
  586.        the second field is the border.  The "bf" is the same format as in
  587.        the Configuration File (see Online Help for details).  Does not
  588.        apply to monochrome displays.
  589.  
  590.  
  591.        Example:
  592.  
  593.                  commo joes zilla /c=other.cfg /m=abc
  594.  
  595.        Two systems will be marked in the Dialing Directory.  The alternate
  596.        Configuration File "other.cfg" will be used (it must be located in
  597.        the {COMMO} home directory).  The macro "abc" will be started if it
  598.        exists in the Macro File.
  599.  
  600.        Note that case is ignored and the order of the switches is
  601.        unimportant (Dialing Strings must be first, however).
  602.  
  603.  
  604.        ---------------------
  605.        {COMMO} Support Files
  606.        ---------------------
  607.  
  608.        The {COMMO} files are standard ASCII text files and may be modified
  609.        with any editor (or word processor in "non-document" mode).  In
  610.        addition all but the Online Help File may be edited with {COMMO}'s
  611.        Internal Editor.
  612.  
  613.        Following is a brief description of each file. 
  614.  
  615.        1) The Configuration File contains settings for many important
  616.           parameters.  When you first run {COMMO} you should use the Alt-G
  617.           key command to edit this file to your own needs.  Save the file
  618.           by pressing [Esc], then "y" or [Enter].  Details for each item in
  619.           this file are given in Online Help.
  620.  
  621.        2) The Dialing Directory File.  This file contains information about
  622.           the systems you will be calling, including the telephone numbers,
  623.           passwords, communication parameters and macro link.  Use the
  624.           Alt-D key command to dial numbers and to edit this file.  Details
  625.           are given in Online Help.
  626.  
  627.        3) The Macro File.  Use the Alt-M key command to select a macro for
  628.  
  629.  
  630.  
  631.                           Welcome to {COMMO} (tm)                   page 10
  632.  
  633.  
  634.           execution and to edit this file.  A complete description of
  635.           {COMMO} macros is given in the section "Programming {COMMO}
  636.           Macros" in this document.  A summary of macro functions and key
  637.           designators is given in Online Help.
  638.  
  639.        4) The Online Help File.  Very extensive Online Help is available at
  640.           the touch of a key from within {COMMO}.  In fact most of the
  641.           operating details of the program are ONLY obtained from Online
  642.           Help.  See "How to Use Online Help" later in this document.
  643.  
  644.  
  645.        ------------------------
  646.        Initialization Procedure
  647.        ------------------------
  648.  
  649.        When {COMMO} begins running it will attempt to load the
  650.        Configuration File (default is COMMO.CFG), COMMO.FON and COMMO.MAC. 
  651.  
  652.        Any problems encountered will be reported in the Initialization
  653.        Window.  These problems must be corrected before restarting the
  654.        program.
  655.  
  656.        Automatic modem initialization will occur if Dialing Strings are
  657.        present (and matches are found), or if the Startup Macro Switch is
  658.        present (see "Command Line Options").
  659.  
  660.        Otherwise you will be asked if you want to initialize your modem. 
  661.        Answer "yes" unless you are already on line.
  662.  
  663.        Please note that {COMMO} does NOT change the video display mode. 
  664.        This means simply that the video mode must be set (usually 25 by 80
  665.        color or monochrome) when you call up the program.  This allows you
  666.        to set video parameters such as the screen border color and not have
  667.        them rudely changed when the program is started.
  668.  
  669.        If the display does not look right try executing the DOS command 
  670.        "mode co80" or "mode bw80" prior to calling {COMMO}.
  671.  
  672.  
  673.        ---------------
  674.        Terminal Screen
  675.        ---------------
  676.  
  677.        The Terminal Screen allows you to see the characters coming in from
  678.        the serial port.  Also any characters that you type will be sent to
  679.        the serial port.  If you are connected to another system you will be
  680.        communicating with that system.
  681.  
  682.        From The Terminal Screen you may call upon any of {COMMO}'s features
  683.        by holding the Alt key and pressing a letter or top row number key,
  684.        then releasing both keys.  To see a list of {COMMO} key commands use
  685.        [Alt-H].
  686.  
  687.        To return to The Terminal Screen simply press [Esc].
  688.  
  689.  
  690.  
  691.                           Welcome to {COMMO} (tm)                   page 11
  692.  
  693.  
  694.        ----------------------
  695.        How to Use Online Help
  696.        ----------------------
  697.  
  698.        Most of {COMMO}'s operating details are available as Online Help by
  699.        pressing [Alt-H] from anywhere in the program.  The Online Help
  700.        support file, COMMO.HLP, must be in the {COMMO} home directory or
  701.        you will get an error message, "Unable to open Help file."
  702.  
  703.        This message will also be issued if there is not enough memory
  704.        (approx. 60k) to load the Online Help file.  Note that the file is
  705.        retained in memory until {COMMO} requires memory for some other
  706.        program function.  It will automatically be re-read when necessary. 
  707.  
  708.        Once the Help window is entered you will see the Help control keys
  709.        listed at the bottom of the screen.  At this point you may obtain
  710.        more detailed information on using Online Help by typing "H".
  711.  
  712.  
  713.        -----------------------
  714.        Modifying the Help File
  715.        -----------------------
  716.  
  717.        Once you are familiar with {COMMO} you may wish to reduce the size
  718.        of the Help File.  Feel free to edit this file with an external
  719.        editor -- you can even set up your own menu.  The search keys are
  720.        the bars separating the topics.  The two digit number in the middle
  721.        of the bar may be changed to create your own key.  Remember to keep
  722.        a backup of the original Help File.
  723.  
  724.  
  725.  
  726.                           Welcome to {COMMO} (tm)                   page 12
  727.  
  728.  
  729.        --------------------------
  730.        Programming {COMMO} Macros
  731.        --------------------------
  732.  
  733.        See the sample Macro File, COMMO.MAC, for examples of more complex
  734.        macro programming.
  735.  
  736.        {COMMO} macros may be used to perform many different operations, yet
  737.        their structure is simple and consistent.  Here are some examples:
  738.  
  739.            {alk} {clear} {stop}
  740.  
  741.        This macro will set Alt-K to clear the screen.  "alk" is called a
  742.        "macro identifier" or "macro-id" for short.  It may be any three
  743.        characters.  Certain macro-id's are reserved to represent keys on
  744.        the keyboard, such as "alk" in this case, and are called "key-id's."
  745.  
  746.        CLEAr is called a "function" and is represented by four or more
  747.        characters of which only the first four are necessary.
  748.  
  749.        The STOP function is used here to terminate the macro and may be
  750.        used in either it's long or short form:
  751.  
  752.          ... {stop}           long form
  753.          ... {}               short form
  754.  
  755.        Note that the default key to clear the screen, Alt-C, is still in
  756.        effect unless it is reassigned.
  757.  
  758.        All {COMMO} key-id's and functions are described in later sections. 
  759.        They are also summarized in Online Help.
  760.  
  761.            {abc} {setlook 30,hng,3,|} {lookfor first name?} {send Fred|} {}
  762.  
  763.        In this macro the SETLook function will set timeout parameters for
  764.        subsequent LOOKfor functions.  The LOOKfor will then watch the data
  765.        coming in from the modem and when it sees "first name?" it will pass
  766.        control to the next function.  In this case the next function, SEND,
  767.        will send the string "Fred" followed by a carriage return (indicated
  768.        by the "|").  Again the STOP function terminates the macro.
  769.  
  770.            {bbs} {capture y,commo.cap} {call abc}
  771.                  {asciiup textfile.xyz,:} {}
  772.  
  773.        This macro will open the capture file "commo.cap" (the "y" means
  774.        "yes", open the file).  Then it will execute the previously
  775.        described macro "abc."  Then it will ASCII Upload the file
  776.        "textfile.xyz" using the pacing character ":".
  777.  
  778.        Note that macros may occupy more than one line in the Macro File.
  779.  
  780.  
  781.  
  782.                           Welcome to {COMMO} (tm)                   page 13
  783.  
  784.  
  785.        Macro-id and Function Summary
  786.        -----------------------------
  787.  
  788.        Macro-id's must be three characters (any character that may be
  789.        entered in the Internal Editor is valid).  Case is ignored so that
  790.        "GK1" is the same as "gk1" or "gK1."
  791.  
  792.        Macro-id's may appear anywhere within macros and may be the targets
  793.        of CALL and GOTO functions.
  794.  
  795.        Function names are four or more characters and may always be
  796.        abbreviated to the first four.  Case is ignored here as well.
  797.  
  798.        Remember to terminate each macro with a STOP function unless it
  799.        already ends with a GOTO or RETUrn.  If you don't, processing will
  800.        continue with the next macro in your Macro File!
  801.  
  802.  
  803.        Additional Macro File Rules
  804.        ---------------------------
  805.  
  806.        The Macro File is entirely free-form.  Macro-id's and functions may
  807.        appear on the same line or on separate lines.  More that one
  808.        macro-id may appear on the same line (only the first may be executed
  809.        from the Macro File window by pressing [Enter]):
  810.  
  811.            {ala} {clear} {}    {alw} {sound n} {}
  812.  
  813.        Comments may appear anywhere outside the curly braces.
  814.  
  815.  
  816.        Executing Macros
  817.        ----------------
  818.  
  819.        Macro execution may be started in a number of ways:
  820.  
  821.        1) Open the Macro Processor window (Alt-M), position the Selector
  822.           Bar on the macro-id and press [Enter] (the macro-id must be the
  823.           first string on the line).
  824.  
  825.        2) If the macro-id is also a key-id, then you may press that key
  826.           from the Terminal Screen.  If the same key-id is used more than
  827.           once, the first occurrence will be used.
  828.  
  829.        3) The macro may be linked to a Dialing Directory entry.  In this
  830.           case it will be CALLed when a connection is established with that
  831.           system.  This macro should end with a RETUrn.
  832.  
  833.        4) The macro may be specified on the command line with the switch
  834.           "/m=".  It will be started as soon as {COMMO} has initialized
  835.           itself.
  836.  
  837.        5) The macro may be an argument of another function such as CALL,
  838.           GOTO, DIAL or SETLook (these are detailed in a later section).
  839.  
  840.  
  841.  
  842.                           Welcome to {COMMO} (tm)                   page 14
  843.  
  844.  
  845.        Additional Macro Execution Rules
  846.        --------------------------------
  847.  
  848.        ASCII keys may be typed to the serial port during LOOKfor, PAUSe and
  849.        HOLD functions.  To send an Esc code press Ctrl [ (Ctrl + left
  850.        bracket).
  851.  
  852.        The Macro Processor will execute functions in order until one of the
  853.        following conditions occur:
  854.  
  855.        1) A CALL, GOTO, RETURn, STOP or EXIT is encountered.
  856.  
  857.        2) Control is transferred to an alternate macro from certain
  858.           functions when a special condition occurs.  An example of this is
  859.           the SETLook function.  The alternate will execute when a
  860.           subsequent LOOKfor times out.
  861.  
  862.        3) The end of the Macro File is reached.
  863.  
  864.        Current function execution may be terminated by pressing [Esc].  For
  865.        example, to terminate a PAUSe or HOLD prematurely.
  866.  
  867.        Overall macro execution may be terminated by pressing [Ctrl-Break]. 
  868.        This will issue an [Esc] to the currently executing function, then
  869.        terminate macro processing and return to the Terminal Screen.
  870.  
  871.        Macro errors will also terminate macro execution and bring up the
  872.        Macro Error window, indicating the location of the problem.
  873.  
  874.        Some macro functions show their current action on the status line at
  875.        the bottom of the screen.  In addition a "face" character in the
  876.        middle of the status line indicates that a macro is executing.
  877.  
  878.  
  879.  
  880.                           Welcome to {COMMO} (tm)                   page 15
  881.  
  882.  
  883.        -----------------------
  884.        {COMMO} Macro Functions
  885.        -----------------------
  886.  
  887.        The purpose of this section is to show the syntax of each function
  888.        and the meaning of its arguments through examples.  Details on
  889.        functions which are also default key commands may be found in Online
  890.        Help.  Other functions will be explained in this section.
  891.  
  892.        Function names are shown with their four-letter abbreviations in
  893.        uppercase.  The following conventions are used in many functions:
  894.  
  895.           "y" or "yes" is used to indicate "yes", "on",  "open",  etc.
  896.           "n" or "no"  is used to indicate "no",  "off", "close", etc.
  897.  
  898.        This provides a highly consistent macro structure which is very easy
  899.        to remember.  When a function is also associated with a default key
  900.        command, the lack of arguments will cause the function to behave
  901.        like the key command -- bringing up a window, for example.
  902.  
  903.  
  904.        Function Arguments
  905.        ------------------
  906.        Arguments are the parameters that follow the function name.  One
  907.        space separates the function name from the arguments (extra spaces
  908.        should be avoided).  Multiple arguments are separated by commas.  
  909.         
  910.            {bbs} {capture y,commo.cap} {call abc}
  911.                  {asciiup textfile.xyz,:} {return}
  912.  
  913.        Here the function CAPTure has two arguments: "y" and "commo.cap."
  914.  
  915.            {abc} {lookfor first name?} {send Fred|} {}
  916.  
  917.        The function LOOKfor has one argument: "first name?".  Quotation
  918.        marks are not used to enclose data strings or filenames in {COMMO}
  919.        macros.
  920.  
  921.  
  922.  
  923.                           Welcome to {COMMO} (tm)                   page 16
  924.  
  925.  
  926.        ALARm
  927.        -----
  928.        Default key: none
  929.        Description: Ring the alarm
  930.  
  931.        Examples:
  932.  
  933.          {alarm}              Ring alarm, ring count in Config. File
  934.          {alarm 2}            Ring alarm 2 times
  935.  
  936.  
  937.        ANSI
  938.        ----
  939.        Default key: Alt-4
  940.        Description: Set ANSI emulation toggle
  941.  
  942.        Examples:
  943.  
  944.          {ansi}               Toggle ANSI emulation on/off
  945.          {ansi y}             Turn on ANSI emulation
  946.          {ansi n}             Turn off ANSI emulation
  947.  
  948.  
  949.        ASCIiup      
  950.        -------
  951.        Default key: Alt-A       
  952.        Description: Upload an ASCII (text) file
  953.  
  954.        Examples:    
  955.  
  956.          {asci}               Open ASCII Upload window
  957.          {asci file.xyz,:}    Upload "file.xyz."  Use ":" for pacing
  958.          {asci file.xyz}      Same, but use current pacing character
  959.          {asci file.xyz,}     Same, but no pacing
  960.          {asci ,?}            Set current pacing character to "?"
  961.          {asci ,}             Set current pacing to "no" pacing
  962.  
  963.  
  964.        AUTObaud
  965.        --------
  966.        Default key: Alt-5
  967.        Description: Set autobaud toggle
  968.  
  969.        Examples:
  970.  
  971.          {auto}               Toggle autobaud on/off
  972.          {auto y}             Turn on autobaud     
  973.          {auto n}             Turn off autobaud
  974.  
  975.  
  976.  
  977.                           Welcome to {COMMO} (tm)                   page 17
  978.  
  979.  
  980.        BEEP
  981.        ----
  982.        Default key: none
  983.        Description: Sound a beep
  984.  
  985.        Examples:
  986.  
  987.          {beep}               No arguments
  988.  
  989.  
  990.        BREAk
  991.        -----
  992.        Default key: Alt-B
  993.        Description: Send a break
  994.  
  995.        Example:
  996.  
  997.          {break}              No arguments
  998.  
  999.  
  1000.        CALL
  1001.        ----
  1002.        Default key: none
  1003.        Description: Execute another macro
  1004.  
  1005.        Example:
  1006.  
  1007.          {call abc}           Execute macro abc
  1008.  
  1009.        If the macro "abc" executes a RETUrn function, then control returns
  1010.        to the function following the CALL.
  1011.  
  1012.        Note that macros may be nested up to 32 deep.  This includes macros
  1013.        called from other functions such as SETLook and DIAL.
  1014.  
  1015.  
  1016.        CAPTure
  1017.        -------
  1018.        Default key: Alt-1
  1019.        Description: Capture File Options
  1020.  
  1021.        Examples:
  1022.  
  1023.          {capture}                      Open Capture File Options window
  1024.          {capture y}                    Open current Capture File
  1025.          {capture n}                    Close current Capture File
  1026.          {capt y,c:\commo\file.xyz}     Open indicated Capture File
  1027.          {capt n,c:\dl\newfile.cap}     Close current Capture File, set new
  1028.                                         file as indicated
  1029.  
  1030.  
  1031.  
  1032.                           Welcome to {COMMO} (tm)                   page 18
  1033.  
  1034.  
  1035.        CHATmode
  1036.        --------
  1037.        Default key: Alt-7
  1038.        Description: Set chat mode toggle
  1039.  
  1040.        Examples:
  1041.  
  1042.          {chat}               Toggle chat mode on/off
  1043.          {chat y}             Turn on chat mode
  1044.          {chat n}             Turn off chat mode
  1045.  
  1046.  
  1047.        CLEAr
  1048.        -----
  1049.        Default key: Alt-C
  1050.        Description: Clear Terminal Screen to default colors
  1051.  
  1052.        Example:
  1053.  
  1054.          {clear}              No arguments
  1055.  
  1056.  
  1057.        CONFig
  1058.        ------
  1059.        Default key: Alt-G
  1060.        Description: Edit Configuration File
  1061.  
  1062.        Example:
  1063.  
  1064.          {config}             No arguments
  1065.  
  1066.  
  1067.        DIAL
  1068.        ----
  1069.        Default key: Alt-D, Alt-U
  1070.        Description: Dialing Directory
  1071.  
  1072.        Examples:
  1073.  
  1074.          {dial}               Open Dialing Directory window (like Alt-D)
  1075.          {dial ,}             Multi Number Dial (like Alt-U)
  1076.          {dial 25,abc}        Multi Number dial with try count
  1077.  
  1078.        25      Maximum number of dialing tries.  If no connection is
  1079.                established when the try count is exhausted, the macro in
  1080.                the second argument will be started.  May be 0 to 999.  "0"
  1081.                means unlimited.  
  1082.  
  1083.        abc     Macro to GOTO if the try count in the first argument is
  1084.                exhausted.  If no macro is specified or if the macro-id is
  1085.                invalid, control will pass to the next function.
  1086.  
  1087.        Default arguments are:    Dialing tries   0 (unlimited)
  1088.                                  Macro           none 
  1089.  
  1090.  
  1091.  
  1092.                           Welcome to {COMMO} (tm)                   page 19
  1093.  
  1094.  
  1095.        Null arguments in the DIAL function will revert to these defaults.
  1096.  
  1097.  
  1098.        Marked numbers will be redialed in sequence.  Numbers may be marked
  1099.        in several ways:
  1100.  
  1101.            1)  Manually in the Dialing Directory window.
  1102.            2)  By placing Dialing Strings on the command line.
  1103.            3)  Using the MARK macro function.
  1104.  
  1105.        If a connection occurs there are two possibilities:
  1106.  
  1107.            1)  If a valid macro is specified in the Dialing Directory, that
  1108.                macro will be started.  When a RETUrn function is
  1109.                encountered {COMMO} will continue dialing other numbers if
  1110.                any are marked.  When no more marked numbers are found,
  1111.                control returns following the DIAL function.
  1112.  
  1113.            2)  If no macro is specified in the Dialing Directory, control
  1114.                is returned to the Terminal Screen and macro processing is
  1115.                terminated.
  1116.  
  1117.  
  1118.        See also the functions: MARK, UNMArk.
  1119.  
  1120.  
  1121.        EXECute
  1122.        -------
  1123.        Default key: none
  1124.        Description: Execute a DOS command
  1125.  
  1126.        A number of special parameters are available to the EXECute function
  1127.        which will either substitute the current value of a variable or
  1128.        perform a specific action before/after command execution:
  1129.  
  1130.           %i   general user Input prompt
  1131.           %p   current serial Port no. (1-4)
  1132.           %s   current Speed (data rate)
  1133.           %u   current Upload directory (from Config)
  1134.           %d   current Download directory (from Config)
  1135.           %c   current Capture file (use Alt-1 to check)
  1136.           %a   sound Alarm at end of command execution
  1137.           %w   Wait before returning to Terminal Screen
  1138.           %%   insert an actual "%" into the command
  1139.  
  1140.        "%i" may be used more than once in a command and will result in a
  1141.        prompt for input in the EXECute DOS Command window.  This is an
  1142.        opportunity to enter a filename or any other information pertinent
  1143.        to the execution of the command.
  1144.  
  1145.        "%w" causes a wait before restoring the Terminal Screen.  This is
  1146.        useful if you need to see the results of the command execution.
  1147.  
  1148.        A wait before and after each EXECute function may be forced by
  1149.        starting a macro with [Ctrl-Enter] instead of [Enter] (from the
  1150.  
  1151.  
  1152.  
  1153.                           Welcome to {COMMO} (tm)                   page 20
  1154.  
  1155.  
  1156.        Macro Processor window only).
  1157.  
  1158.        Examples:
  1159.  
  1160.          {exec dsz port %p speed %s sz %u\%i %a%w}
  1161.  
  1162.           {COMMO} will prepare the DSZ command by substituting the "%"
  1163.           parameters, then call DOS to execute the program.  The alarm will
  1164.           sound at completion and {COMMO} will wait for a keypress before
  1165.           resuming.
  1166.  
  1167.          {exec list %c}
  1168.  
  1169.           The LIST program will be executed with the current Capture File
  1170.           as a command line argument.  {COMMO} will return immediately to
  1171.           the Terminal Screen when LIST exits.
  1172.  
  1173.  
  1174.        EXEN
  1175.        ----
  1176.        Default key: none
  1177.        Description: Execute a DOS command, do not clear the screen
  1178.  
  1179.        This function is exactly the same as EXECute, but the Terminal
  1180.        Screen is not cleared when the command is sent to DOS.  It is used
  1181.        to prevent the screen from "flickering" when programs or DOS
  1182.        commands execute rapidly.
  1183.  
  1184.        Examples:
  1185.  
  1186.          {exen del c:\commo\commo.cap}
  1187.          {exen ren commo.cap joes-bbs.cap}
  1188.  
  1189.  
  1190.        EXIT
  1191.        ----
  1192.        Default key: Alt-X
  1193.        Description: Exit {COMMO}
  1194.  
  1195.        Example:
  1196.  
  1197.          {exit}               No arguments
  1198.  
  1199.  
  1200.        GOTO
  1201.        ----
  1202.        Default key: none
  1203.        Description: Transfer control to a macro-id
  1204.  
  1205.        Example:
  1206.  
  1207.          {goto x21}           Control transferred to "x21"
  1208.  
  1209.  
  1210.  
  1211.                           Welcome to {COMMO} (tm)                   page 21
  1212.  
  1213.  
  1214.        HANGup
  1215.        ------
  1216.        Default key: Alt-Q
  1217.        Description: Disconnect by dropping DTR
  1218.  
  1219.        Examples:
  1220.  
  1221.          {hangup}             Prompt user for disconnect
  1222.          {hangup y}           Disconnect without prompting
  1223.  
  1224.  
  1225.        HELP
  1226.        ----
  1227.        Default key: Alt-H
  1228.        Description: Open Online Help window
  1229.  
  1230.        Example:
  1231.  
  1232.          {help}               No arguments
  1233.  
  1234.  
  1235.        HOLD
  1236.        ----
  1237.        Default key: none
  1238.        Description: Hold until specified time of day (24 hour format)
  1239.  
  1240.        Examples:
  1241.  
  1242.          {hold 3:30}          Hold until 3:30 am
  1243.          {hold 16:10}         Hold until 4:10 pm
  1244.          {hold 0:00}          Hold until midnight
  1245.  
  1246.  
  1247.        INITmodem
  1248.        ---------
  1249.        Default key: Alt-O
  1250.        Description: Send modem initialization string
  1251.  
  1252.        Example:
  1253.  
  1254.          {init}               No arguments
  1255.  
  1256.  
  1257.        LIGHts
  1258.        ------
  1259.        Default key: Alt-0
  1260.        Description: Set signal lights toggle
  1261.  
  1262.        Examples:
  1263.  
  1264.          {lights}             Toggle signal lights on/off
  1265.          {lights y}           Turn on signal lights
  1266.          {lights n}           Turn off signal lights
  1267.  
  1268.  
  1269.  
  1270.                           Welcome to {COMMO} (tm)                   page 22
  1271.  
  1272.  
  1273.        LOCAlecho
  1274.        ---------
  1275.        Default key: Alt-6
  1276.        Description: Set local echo toggle
  1277.  
  1278.        Examples:
  1279.  
  1280.          {local}              Toggle local echo on/off
  1281.          {local y}            Turn on local echo
  1282.          {local n}            Turn off local echo
  1283.  
  1284.  
  1285.        LOOKfor
  1286.        -------
  1287.        Default key: none
  1288.        Description: Look for a string in the modem input stream
  1289.  
  1290.        Example:
  1291.  
  1292.          {setlook 60,abc,4,n|}     Set parameters
  1293.          {lookfor first name?}     Look for the string "first name?"
  1294.          {look ^(COMMO^)}          Look for the string "{COMMO}"
  1295.  
  1296.  
  1297.        Parameters controlling LOOKfor execution are set with the SETLook
  1298.        function, which should be executed before any LOOKfor functions. 
  1299.        See description of SETLook function for details.
  1300.  
  1301.        The LOOKfor function will watch for the requested string to appear,
  1302.        then macro execution will continue with the next function.
  1303.  
  1304.        Case will be ignored and ANSI control sequences will be stripped
  1305.        out.  Thus you needn't be concerned about remembering if any
  1306.        characters were upper or lower case, nor do you have to tell the
  1307.        remote to turn off ANSI graphics. 
  1308.  
  1309.        Note that there are special rules for representing characters in
  1310.        LOOKfor strings.  See Appendix D "Strings in {COMMO} Files" for
  1311.        details.
  1312.  
  1313.  
  1314.        MACRo
  1315.        -----
  1316.        Default key: Alt-M
  1317.        Description: Open Macro Processor window
  1318.  
  1319.        Example:
  1320.  
  1321.          {macro}              no arguments
  1322.  
  1323.  
  1324.  
  1325.                           Welcome to {COMMO} (tm)                   page 23
  1326.  
  1327.  
  1328.        MARK
  1329.        ----
  1330.        Default key: none
  1331.        Description: Mark Dialing Directory entries for dialing
  1332.  
  1333.        Example:
  1334.  
  1335.          {mark joes-bbs,file-city}      Mark entries for dialing
  1336.  
  1337.        Dialing Strings may be separated by spaces or commas.
  1338.  
  1339.        {COMMO} will search the Dialing Directory for each string and mark
  1340.        the first entry where a match is found.  Case is ignored.
  1341.  
  1342.        The strings may consist of any part of a Dialing Directory entry
  1343.        line.  However the following characters may not appear in a dialing
  1344.        string: space, comma, slash (/), left or right curly brace. 
  1345.  
  1346.        See also the functions: DIAL, UNMArk.
  1347.  
  1348.  
  1349.        NOOP
  1350.        ----
  1351.        Default key: none
  1352.        Description: No-op function, does nothing
  1353.  
  1354.        Example:
  1355.  
  1356.          {noop}               no arguments
  1357.  
  1358.  
  1359.        PARMs
  1360.        -----
  1361.        Default key: Alt-L
  1362.        Description: Change communication parameters
  1363.  
  1364.        Examples:
  1365.  
  1366.          {parms 2,2400,8}     Set Com2, 2400 bps, 8,n,1
  1367.          {parms 1,19200,7}    Set Com1, 19200 bps, 7,e,1
  1368.  
  1369.  
  1370.        PASSword
  1371.        --------
  1372.        Default key: Alt-P
  1373.        Description: Send current password
  1374.  
  1375.        Example:
  1376.  
  1377.          {password}           No arguments
  1378.  
  1379.        The current password is obtained from the Dialing Directory entry
  1380.        whenever a number is dialed.  If no password is specified no
  1381.        characters will be sent.
  1382.  
  1383.  
  1384.  
  1385.                           Welcome to {COMMO} (tm)                   page 24
  1386.  
  1387.  
  1388.  
  1389.        PAUSe
  1390.        -----
  1391.        Default key: none
  1392.        Description: Pause for up to 999 seconds
  1393.  
  1394.        Example:
  1395.  
  1396.          {pause 25}           Pause for 25 seconds
  1397.  
  1398.  
  1399.        PRINtlog
  1400.        --------
  1401.        Default key: Alt-2
  1402.        Description: Set print log toggle
  1403.  
  1404.        Examples:
  1405.  
  1406.          {print}              Toggle print log on/off
  1407.          {print y}            Turn on print log     
  1408.          {print n}            Turn off print log
  1409.  
  1410.  
  1411.        RETUrn
  1412.        ------
  1413.        Default key: none
  1414.        Description: Return from a CALLed macro
  1415.  
  1416.        Example:
  1417.  
  1418.          {return}             no arguments
  1419.  
  1420.        This function will return control to the function following the most
  1421.        recent CALL.  It should also be used to RETUrn from Dialing
  1422.        Directory macros.
  1423.  
  1424.  
  1425.        SCREen
  1426.        ------
  1427.        Default key: Alt-I
  1428.        Description: Screen Image Save
  1429.  
  1430.        Examples:
  1431.  
  1432.          {screen}                  Open Screen Image Save window
  1433.          {screen y}                Append screen image to current file 
  1434.          {screen y,commo.scn}      Append screen image to indicated file
  1435.          {screen n,c:\file.xyz}    Change current screen image pathname
  1436.  
  1437.  
  1438.  
  1439.                           Welcome to {COMMO} (tm)                   page 25
  1440.  
  1441.  
  1442.        SEND
  1443.        ----
  1444.        Default key: none
  1445.        Description: Send a string to the modem
  1446.  
  1447.        Example:
  1448.  
  1449.          {send Fred|~~Brucker|~~#|}     Send my first and last name with
  1450.                                         carriage returns and 1 second
  1451.                                         delays, then send the current
  1452.                                         password and <cr>.
  1453.  
  1454.        Note: see Appendix D "Strings in {COMMO} Files" for information on
  1455.        how to represent any character in a SEND function.
  1456.  
  1457.  
  1458.        SETLook
  1459.        -------
  1460.        Default key: none
  1461.        Description: Set parameters for LOOKfor functions
  1462.  
  1463.        Example:
  1464.  
  1465.          {setl 60,abc,4,n|}        Set LOOKfor parameters
  1466.  
  1467.        60      LOOKfor timeout.  Maximum time in seconds to look for a
  1468.                string.  If the string is not found in the allotted time,
  1469.                the macro in the second argument will be started.  May be 0
  1470.                to 999.  "0" means forever.  
  1471.  
  1472.        abc     Timeout macro.  Macro to GOTO if the time in the first
  1473.                argument expires.  If no macro is specified or if the
  1474.                macro-id is invalid, control will pass to the next function.
  1475.  
  1476.        4       Prompt timeout.  During a LOOKfor function unwanted prompts
  1477.                may appear like "Press any key" or "More [Y/n]", etc.  
  1478.                This argument is the time in seconds to wait at a prompt (no
  1479.                input from the modem) before sending the string in the
  1480.                fourth argument.  Usually you would send "|" or "n|".
  1481.  
  1482.                When the string is sent the process is restarted, allowing
  1483.                any number of prompts to be satisfied (until the LOOKfor
  1484.                itself is satisfied or times out).
  1485.  
  1486.                Make sure this value is high enough to give the host system
  1487.                time to "think" when it is in between prompts.  Some systems
  1488.                take longer to do things.  May be 0 to 999.  "0" means
  1489.                forever.
  1490.  
  1491.        n|      Prompt response.  String to send when the time in the third
  1492.                argument runs out.
  1493.  
  1494.        The SETLook function will set parameters for any subsequent
  1495.        LOOKfor's.  SETLook may be executed at any time to modify the
  1496.        parameters.
  1497.  
  1498.  
  1499.  
  1500.                           Welcome to {COMMO} (tm)                   page 26
  1501.  
  1502.  
  1503.  
  1504.        Default arguments are:    LOOKfor timeout  0 seconds
  1505.                                  Timeout macro    none 
  1506.                                  Prompt timeout   0 seconds
  1507.                                  Prompt response  none
  1508.  
  1509.        Null arguments in the SETLook function will revert to these
  1510.        defaults.
  1511.  
  1512.  
  1513.        SHELl
  1514.        -----
  1515.        Default key: Alt-S
  1516.        Description: Shell to DOS
  1517.  
  1518.        Example:
  1519.  
  1520.          {shell}              No arguments
  1521.  
  1522.  
  1523.        SOUNd
  1524.        -----
  1525.        Default key: Alt-3
  1526.        Description: Set master sound toggle
  1527.  
  1528.        Examples:
  1529.  
  1530.          {sound}              Toggle master sound on/off
  1531.          {sound y}            Turn on master sound
  1532.          {sound n}            Turn off master sound
  1533.  
  1534.  
  1535.        STOP
  1536.        ----
  1537.        Default key: none
  1538.        Description: Halt macro execution
  1539.  
  1540.        Examples:
  1541.  
  1542.          {stop}               No arguments
  1543.          {}                   Short form
  1544.  
  1545.  
  1546.        UNMArk
  1547.        ------
  1548.        Default key: none
  1549.        Description: Unmark all entries marked for dialing in the Dialing
  1550.                     Directory
  1551.  
  1552.        Example:
  1553.  
  1554.          {unmark}             No arguments
  1555.  
  1556.        See also the functions: DIAL, MARK.
  1557.  
  1558.  
  1559.  
  1560.                           Welcome to {COMMO} (tm)                   page 27
  1561.  
  1562.  
  1563.        -------------------------
  1564.        Table of {COMMO} Key-id's
  1565.        -------------------------
  1566.  
  1567.        Key-id's are also macro-id's with the added advantage that the macro
  1568.        can be started by pressing the assocaiated key from the Terminal
  1569.        Screen.  Most "special" keys may be assigned this way.  If the same
  1570.        key-id appears more than once, the first occurrence will be used. 
  1571.        Note that key-id's are case insensitive.  The caret (^) indicates
  1572.        the Ctrl key.
  1573.  
  1574.  
  1575.                Key Name     Key-id        Key Name     Key-id
  1576.                ________     ______        ________     ______
  1577.  
  1578.                Normal-F1     nf1          Normal-F10    nf0
  1579.                Ctrl-F1       cf1          Ctrl-F10      cf0
  1580.                Shift-F1      sf1          Shift-F10     sf0
  1581.                Alt-F1        af1          Alt-F10       af0
  1582.  
  1583.                Alt-A         ala          Alt-Z         alz
  1584.                Alt-1         al1          Alt-0         al0
  1585.                Alt =         al=          Alt -         al-
  1586.  
  1587.                Escape        esc          Grey *        gr*
  1588.                Grey -        gr-          Grey +        gr+
  1589.  
  1590.                Backspace     bsp          ^Backspace    cbs
  1591.                Tab           tab          Shift-tab     stb
  1592.                Enter         ent          ^Enter        cen
  1593.  
  1594.                Home          hom          End           end
  1595.                PgUp          pgu          PgDn          pgd
  1596.                Up-Arrow      upa          Down-Arrow    dna
  1597.                Left-Arrow    lfa          Right-Arrow   rta
  1598.                Insert        ins          Delete        del
  1599.  
  1600.                ^Home         chm          ^End          cnd
  1601.                ^PgUp         cpu          ^PgDn         cpd
  1602.                ^Right-Arrow  cra          ^Left-Arrow   cla
  1603.  
  1604.                Keypad-0      kp0          Keypad-9      kp9
  1605.                Keypad-.      kp.          ^PrtSc        cpr
  1606.  
  1607.  
  1608.  
  1609.                           Welcome to {COMMO} (tm)                   page 28
  1610.  
  1611.  
  1612.        ----------   ---------------------
  1613.        Appendix A   Setting Up Your Modem
  1614.        ----------   ---------------------
  1615.  
  1616.        Please be aware that there are many different modems in use and that
  1617.        it is of the utmost importance that you configure your modem to work
  1618.        correctly with {COMMO}.  A few tips will be given here, but they are
  1619.        no substitute for the detailed installation instructions in your
  1620.        modem manual!
  1621.  
  1622.        When {COMMO} is started a command string will be sent to the modem
  1623.        called the Modem Initialization String.  You must make certain that
  1624.        the correct string is set up in your Configuration File (Item 4). 
  1625.        This string will perform part or all of the modem setup depending on
  1626.        the type of modem.  Examples will be given for the most common
  1627.        types.
  1628.  
  1629.        If your modem is external to your computer, be sure you have
  1630.        followed the installation instructions carefully and that the cable
  1631.        is connected to the computer's serial port.  It is wise to turn off
  1632.        power to the computer and the modem when connecting or disconnecting
  1633.        any cables.
  1634.  
  1635.        In any case note the number of the serial port that you have used --
  1636.        Com1, Com2, ... , etc.  The numeric part of the serial port number
  1637.        (1, 2, ... ) must be placed in Item 1 of the Configuration File. 
  1638.        Also check the default speed in Item 2.
  1639.  
  1640.        1200 bps Modems
  1641.        _______________
  1642.  
  1643.        Most 1200 bps modems have switches on them which must be set to
  1644.        provide the proper interaction with your computer and with {COMMO}. 
  1645.        Consult your modem manual concerning these switches and pay
  1646.        particular attention to the following:
  1647.  
  1648.        1) Enable command recognition.  Allows the modem to recognize
  1649.           commands (dial, set registers, etc.).  Must be in the "enable"
  1650.           position or modem will be unusable.
  1651.  
  1652.        2) Send result codes in English.  This switch should be set so that
  1653.           the modem will send verbal responses to commands instead of
  1654.           numbers.  This is usually controlled by a command also (such as
  1655.           ATV1).
  1656.  
  1657.        3) Respond to DTR (data terminal ready).  This should NOT be in the
  1658.           "ignore" position.  This switch allows the computer to signal the
  1659.           modem to hang up.
  1660.  
  1661.        4) Force carrier detect.  This switch should be set to "respond to
  1662.           carrier detect" or "allow true carrier."
  1663.  
  1664.        Here is an example modem initialization string (Configuration File
  1665.        Item 4) which will set up a 1200 bps modem and override the switch
  1666.        settings (if possible):
  1667.  
  1668.  
  1669.  
  1670.                           Welcome to {COMMO} (tm)                   page 29
  1671.  
  1672.  
  1673.  
  1674.           4 * {AT S0=0 S7=45 E0 Q0 V1 X1 |}   Modem init string     
  1675.  
  1676.        The most important command is the "X" command, since its function
  1677.        varies the most from modem to modem.  The "X" command determines
  1678.        which responses the modem will generate during dialing (e.g.
  1679.        CONNECT, BUSY, etc.).  It may also activate an additional modem
  1680.        feature such as automatic redialing which will interfere with
  1681.        {COMMO}'s own redialing procedure.
  1682.  
  1683.        Your modem manual gives a description for each level of the "X"
  1684.        command: X0, X1, X2, ... , etc.  Generally you want to use the
  1685.        highest level that does not activate undesirable features.  If you
  1686.        will be using {COMMO}'s AutoBaud feature you will need the extended
  1687.        connect responses such as CONNECT 1200.  Also the BUSY response
  1688.        should be provided if possible.  In any case you should modify the
  1689.        Modem Initialization String to work with your particular modem.
  1690.  
  1691.        2400 bps and higher
  1692.        ___________________
  1693.  
  1694.        Modems which operate at 2400 bps and higher generally have commands
  1695.        to replace the switches.  These commands may be given every time you
  1696.        start {COMMO} or they may be permanently remembered by modems which
  1697.        have "non-volatile" memory.
  1698.  
  1699.        It will be assumed here that the commands are given every time you
  1700.        start {COMMO}.  If you wish to place the settings in non-volatile
  1701.        memory, consult your modem manual on how to do this.  Here is an
  1702.        example initialization string for 2400 bps (and higher) modems:
  1703.  
  1704.           4 * {AT S0=0 S7=45 E0 Q0 V1 X4 &C1 &D2 |}   Modem init string  
  1705.  
  1706.        See the comments above concerning the "X" command since they apply
  1707.        to these modems as well.
  1708.  
  1709.  
  1710.        If {COMMO} is already running you may edit the Configuration File
  1711.        with the Alt-G key command, change the modem initialization string 
  1712.        (save the file), then use the Alt-O key command to send the string
  1713.        to the modem.  Normally the string is sent to the modem when {COMMO}
  1714.        is started.
  1715.  
  1716.  
  1717.  
  1718.                           Welcome to {COMMO} (tm)                   page 30
  1719.  
  1720.  
  1721.        ----------   --------------------
  1722.        Appendix B   {COMMO} and DESQview
  1723.        ----------   --------------------
  1724.  
  1725.        Special care has been taken to insure that {COMMO} is compatible
  1726.        with Quarterdeck Office Systems' DESQview(tm), a multi-tasking
  1727.        supervisor.  DESQview allows more than one program to execute at the
  1728.        same time.
  1729.  
  1730.        A sample Program Information File (CO-PIF.DVP) has been included in
  1731.        the {COMMO} package for your convenience.  This file has been set up
  1732.        to define a 120k memory window, allowing DSZ and LIST to be run from
  1733.        the Macro Processor.
  1734.  
  1735.        If a DOS command (or program run from the Shell to DOS) will not
  1736.        execute due to insufficient memory, this number will have to be
  1737.        increased.  Be sure to test DOS commands with a "wait" at the end so
  1738.        that you can see any error messages (see EXEC function).
  1739.  
  1740.        You may be able to make this window smaller by reducing the size of
  1741.        {COMMO}'s support files and/or by running smaller programs with
  1742.        Shell to DOS or with the Macro Processor.
  1743.  
  1744.        CO-PIF.DVP can be changed with the CP (Change Program) command on
  1745.        the Open Window menu.  You may also want to change the directory
  1746.        information or other parameters.
  1747.  
  1748.        Here are some tips on using {COMMO} with DESQview:
  1749.  
  1750.           If you switch to another task, do not attempt to access any files
  1751.           which may be in use in the {COMMO} window.  Examples are the
  1752.           Capture File, the Screen Image File and files that may be
  1753.           currently involved in a file transfer (upload or download).  The
  1754.           result may be a loss of part or all of the data in the file. 
  1755.           This is a general DESQview no-no.  You may freely access these
  1756.           files in the Shell to DOS or Macro Processor features of {COMMO}
  1757.           (within the same window).
  1758.  
  1759.           If the window is too small, {COMMO} will not be able to load the
  1760.           Online Help file.  To use Online Help you will need a window with
  1761.           about 60k of memory available AFTER loading {COMMO}.  Since the
  1762.           Online Help file is loaded dynamically, you needn't be concerned
  1763.           if you don't intend to use it.
  1764.  
  1765.           The video display may seem less smooth in DESQview.  This is a
  1766.           result of {COMMO} using the fastest possible display method, and
  1767.           is quite normal.
  1768.  
  1769.           The Snow Checking toggle should not be used when {COMMO} is run
  1770.           under DESQview.  If you see "snow" type interference in your CGA
  1771.           display, use DESQview's own snow checking (request "synchronized
  1772.           access" in the Setup program).
  1773.  
  1774.  
  1775.  
  1776.                           Welcome to {COMMO} (tm)                   page 31
  1777.  
  1778.  
  1779.        ----------   -----------------
  1780.        Appendix C   XON/XOFF Protocol
  1781.        ----------   -----------------
  1782.  
  1783.        The XON/XOFF protocol is in effect at all times.  XON/XOFF is
  1784.        especially important when the Print Log is on, since the printer is
  1785.        a slow device relative to the transmission rate of data.
  1786.  
  1787.        {COMMO} will send an XOFF (^S) to pause the remote when data is
  1788.        coming in too fast, and then send an XON (^Q) when it has caught up. 
  1789.        If you attempt to type a character to the remote during a pause a
  1790.        beep will sound (the character will be ignored).  Try typing the
  1791.        character again; if that fails turn off the Print Log.  
  1792.  
  1793.        This situation may arise, for example, if you want to type a ^K to
  1794.        stop the output of the BBS (you probably want to stop the Print Log
  1795.        at this point anyway).
  1796.  
  1797.  
  1798.  
  1799.                           Welcome to {COMMO} (tm)                   page 32
  1800.  
  1801.  
  1802.        ----------   ------------------------
  1803.        Appendix D   Strings in {COMMO} Files
  1804.        ----------   ------------------------
  1805.  
  1806.        "Strings" are defined in {COMMO} as groups of characters enclosed
  1807.        within curly braces, as: {I am a string}.  Strings are used in the
  1808.        {COMMO} support files (Configuration File, Dialing Directory, Macro
  1809.        File) to contain parameters necessary to each file's function.
  1810.  
  1811.        Curly braces may ONLY appear as delimiters to begin and end strings. 
  1812.        They may not appear in the commentary nor within strings.
  1813.  
  1814.  
  1815.        ASCII Data Strings
  1816.        __________________
  1817.  
  1818.        Some of the strings in the {COMMO} support files are ASCII Data
  1819.        Strings.  These include:
  1820.  
  1821.             Modem initialization string     (Config. File)
  1822.             Dial prefix                     (Config. File)
  1823.             Dial suffix                     (Config. File)
  1824.             Telephone number                (Dialing Directory)
  1825.             Password string                 (Dialing Directory)
  1826.             Strings in Macro functions such
  1827.               as SEND, SETLook and LOOKfor  (Macro File)
  1828.  
  1829.        Note that most of these are sent to the modem.
  1830.  
  1831.        Some characters have special significance in these strings.  Any
  1832.        character in the extended ASCII chart may be included, although some
  1833.        must be represented in a special way.
  1834.  
  1835.        The following special characters may be used in ASCII Data strings:
  1836.  
  1837.           The vertical bar (|) represents a carriage return.
  1838.  
  1839.           The tilde (~) forces a one-half second delay (modem output only).
  1840.  
  1841.           The pound sign (#), in the SEND function only, will cause the  
  1842.           current Password String to be sent in its place.
  1843.  
  1844.  
  1845.           The caret (^) is used to represent ASCII values which may not be 
  1846.           entered from the keyboard:
  1847.  
  1848.             0  ... ^@      7  ... ^G      14 ... ^N      21 ... ^U
  1849.             1  ... ^A      8  ... ^H      15 ... ^O      22 ... ^V
  1850.             2  ... ^B      9  ... ^I      16 ... ^P      23 ... ^W
  1851.             3  ... ^C      10 ... ^J      17 ... ^Q      24 ... ^X
  1852.             4  ... ^D      11 ... ^K      18 ... ^R      25 ... ^Y
  1853.             5  ... ^E      12 ... ^L      19 ... ^S      26 ... ^Z
  1854.             6  ... ^F      13 ... ^M      20 ... ^T      27 ... ^[
  1855.  
  1856.  
  1857.  
  1858.                           Welcome to {COMMO} (tm)                   page 33
  1859.  
  1860.  
  1861.           The caret (^) is also used to represent the following:
  1862.  
  1863.             {  ... ^(      the left curly brace
  1864.             }  ... ^)      the right curly brace
  1865.             |  ... ^|      the vertical bar
  1866.             ~  ... ^~      the tilde
  1867.             #  ... ^#      the pound sign
  1868.             ^  ... ^^      the caret
  1869.  
  1870.        These particular characters should only appear in this form, while
  1871.        others such as ASCII 28 through 31 and those in the upper 128
  1872.        extended character set may be typed using the Alt-numeric-keypad
  1873.        method as follows:
  1874.  
  1875.           1. Hold down the Alt key (and keep it down).
  1876.  
  1877.           2. Enter the ASCII code in decimal using the numeric keypad keys
  1878.              (1, 2 or 3 digits are ok).
  1879.  
  1880.           3. Release the Alt key.
  1881.  
  1882.        ASCII 28 through 31 may also be typed using the Ctrl key on your
  1883.        keyboard:
  1884.  
  1885.             28 ... Ctrl \
  1886.             29 ... Ctrl ]
  1887.             30 ... Ctrl 6
  1888.             31 ... Ctrl -
  1889.  
  1890.        All other characters are entered in the usual manner.
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.                                    - end -
  1898.  
  1899.